Syntax: RUN GH 
BASIC09 to do 
GFX2([path]<funct 
handle enhanced 
Usage : Graphics 
windowing comrn 
help to users will 
<s>IDENT Syntax: 
from OS-9 memoi 

single line output 

directory <5>INIZ Svnl 
<o>INKEV Syntax * 



sides 'No* of cylinders' On decimal) interleave value: On decimal) <s>FREE Syntax: 
Free [devname] Usage : Displays number of free sectors on a device @GFX 

Ice package for 

Syntax: RUN 

BASIC09 to 

Syntax: none 

die graphics/ 

Give on-line 

of help topics 

r information 

mory -s = use 

at execution 

Sttach a device 

subroutine to 
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@>MODP 
memory 
compare 
to module 
module M * mask 
Usage : Set 
monochrome 
and links an 
Procs [e] Usagi 
display all pro 
current data c 
execution direc 
Usage : Gives 
module> Usag 
[Yy/mm/dd/hh:i 
Syntax: Setpr 
num @SHELLT5 
@TMODE Syntax: 
the ope 
[value] 
<modna 
Wcreatt 
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erify 

Montype [opt] 

monitor m - 

e : Creates 

Syntax: 

Opts : e = 

Prints the 

he current 

filename> 

nb <i-code 

ax: Setime 

@SETPR 

process to 

interpreter 

IspTayTor changes 



¥®3uasnsi® 




Initialize anVxre^e^^aows^^^ 

from stdin -s=type = set screen type for a window on a new screen @XMODE 
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fclelcoEe to our Aucust edition of the usergroup 
nsss letter which is the last for the [ur rent- 
subscription year. This also brinos us to the 
end of the third ye3r of the National OSS 
Useroroup since being revived in sunny 
Queesland. Please use the application fori* 
attached to renev your subscription for the 
coEing year as this will ensure that we have 
current information scout you and vour OSS 
system, 

I s;ust say that *e are just a little suorised at 
the number of enouiries received recently fro** 
oeoole lust writer inn the OS'^ world on a CoCoS 
plaffon? desoits the obvious difficulties in 
obtaining the riicroware £865 039 level 2 for the 

'" r.' 1 . r.r f'nmr:F ]t or Sw the nH'-.r it \tr-'< tTAt : At 

w w' * w 1 i uVnib'Jvbi . w t vi!w tf w i . J. ; i • J U i-. . I ■_• M V I 

LmrhriHv Mint i "A t* niirrhjc: the fiVM i '"' rir.pr:t mr, 

u i < i ur v v < wail v t ll'j v '- u ui < btiu j. wliu uv_> i_ i_ vww - u v iuu 

5-./c?c& Mr * i"ie r" ;•: r :-■ V it ■ c p^c-i's-ia tr-i-iK:'- 



rUcroware ooeratinq system for tne SSttofc fasiiy 
of orocsssors. 

DS-9ftft© What about GS-9i)w$ for the 336/PC and 

clones? Hicrot-sre 1 s recentlv released operative 
system for 386 oased machines has very similar 
architecture and features to OS-S 

A direct auots fror riicroware's handout 
'Questions I Answers for serious 38b /PC users 1 
i: 0S-9^6 is a ^ocular real-tias ftulti-user, 
rsul ^ ' : -taski no oo^atinc svS'-es d^si^ned t r - 
un'^asn the oo^er of vour 3A't/PC co^Da* 7 '" 1 ^ 
no* you can have powerful vHE-style software for 

i/,--;rr. pf- ? + 3 n«irp V'"'" r 3 ™ i*triT>t"i Pai t iir-i rin 

iv'ji : u . . , G V W V 1 i V C V-" « W U I 1 « i I W I W . : hwvll! in J 

a Rotable reai-tise Kernel file sanaoers 

•;t i i i * i o: ;nr* not inn*!/ i rir, An A i j-rjc Hv-QWHit 

rifrprc ynij ^pjc, ultimate r Pi 1 ~ t^ i jst ^oftssr^ 

HiUi | rpfiipnT r ! s t f a r r ; t'r* wwir- Vpk hsr ni,isrc i: 

Ui. > ^ilLiLiEiiv w » u t ! '_■ i In i w I i v u i v V -_■ i:ui uiiul k 
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-••■.]■■ nr.r.mr: c;;nArir-t wr.ii t,ti ! \ -• j en r,;.ar KUtff 

CRsal-t ime Audio/Visual Environment) shi c h 

iBinr.n ■ ' ^ct 1 ih?nnc n*"terc in .Har. sr s i p,^ i at-, 37^ 

UHIVIIU W V I I 1_ 1 ■■■ I « t 1 1 V -J ; J 1 C k J • 1. WI WW UlltlilQ L~tl.ll All! 

CD-cualitv sound 



Pr-irp, tifV •■!£ Qs ?l:ic ^iminr i k:nHHr,n 

l i j.vC *v-_- ^ *» , _■ \j i I'm-- 'JhtVf ill'J ti nullui ili'J 

ftjnu At ^jc however are look inn for th c "yh^re 
to next". QSr. will proDabiy oe the logical 
uoorade for &any of us CoCo users with the big 
ouestion still being;- what new cosiouter should 
I invest m? 

This newsletter contains an update on the status 
of the HH1 cjeveiopaent "as is" released Dv IHS 
(Interactive Media Systems ) early July. The HK1 
certainly promises to De an exciting QS-3 
olatfors. ye have devoted sose three oaoes to 
this "release" in order to orinq you the latest 
information anc trust that it is of interest 
even if vou nave not been tempted to ace an MH1 
to vour y ish list. 

T* i- ;icr interact inn ♦ r. nntp t^-4^ Wi .- T-Ahiri^p ' c 

oenenc ters 0S~S refers to what we have known 
as QSK or GS-S 63^0 and in fact nas done for 
scrae tiae . The magazine H PiDelines i; produced by 
rlicroware no lonoe^* nas any reference to 0S~S 
faSe9 which they droooeo so^e tiise aco : to be uo 



For sor^ information "ont^ct th fi Australian 

•i!(-pc|h:;i-t- UAiTit - 

: i i w i -.'ww-.i C w- u u ; i i. i 

■"ii croorocesso^' Cnnsultsnt^ P/- 

Avaion Beach N8W 2l«7 
Phone 62 S7i ^S;7 

will *e ever become the National u3-360 v 
Usergroup- I con ! t think so, but here is an 
alternative which t&ay De attractive to scEie. I 
have no details of prices, but expect that one 
toulc need Bore than just a hobby m Bind to 
encuire. 

ye trust that vou find soEethmo of interest m 
this "S-S letter and re&md vou that 
contributions for inclusion are most wekoae. 
VOU can change the content siapiy dv sending 
vou" article to the editor. This Usergrouo is 
operated on a non-profit basis *'ith the a iff' of 
assisting OS-Sers. so if you feel that you are 
no: acle to contribute, please let us Know t^na: 
vou youic iil'e to see includeo in future 
newsletters. 

rKcDr" f-iAT---iAn 
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yhere we stand on the MM/ 
by Paul yard 



To help keep you up to date, here is a file that 
tells you: that we are trying to accomplish, 
what we are accoaplishing, and that we have done 
to iaprove the MM/I and IMS. 

IMS, Inc. was created to bring you the MM/1 and 
affordable OSK software. The MM/1 was and is a 
group project thought up by this coaaunity. 
Many of you contributed ideas, and you still 
have a vital role to play by actively 
participating in providing constructive feedback 
to Interactive Media Systeas ; Inc. All input is 
considered and appreciated. 



through Friday. (We will be closed 
honor of Independence Dav.) 



July i 



What IMS 



rvinq to accoapiisn 



Soai: Solve the Software/Hardware Paradox 

You can't have software that is good quality 
unless the software vendors have a large aarket 
to sell to. Yet you won't buy a coaputer unless 
it has good software. 



Before we get started, let's evaluate yhere the 
MM/ I is now. 

First, the two board kit is still being sold. 
The price has been raised to *975, so the $875 
special price is now over. Also, our case price 
has been raised froa *i$£ to 4125. with the kit 
coaes with soae additional free software, 
enhanced windowing software, new documentation 
and with soae technical literature. 

Second, aore technical literature is being 
prepared that will also provide specific ideas 
on projects with the MM/1. 

Third, iaproved SCSI drivers are in beta test 
that bring the MM/I's SCSI subsystea to 
workstation level speeds — 1.8 Megabytes per 
second transfer rates on a Quant ua Pro drive. 

Fourth, updated hardware and software is 
beginning to be distributed to developers. 

Fifth, the MM/1 kits are shipping. Ve had soae 
delays after the Fest with a aask error western 
Digital introduced into their SCSI host adapter 
chip. Kits yiTHQUT the I/O board are shipping 
noWj and have been shipping for weeks, ye should 
have well over one hundred MM/ is in the field by 
the end of July, and shipping will continue 
through August until we are caught up. 

The aask change of the SCSI host adapter chip 
was introduced only in later aodels by Western 
Digital. Three hundred chips froa an older aask 
have been reserved for IMS, These are being 
tested this week. An update will be available 
soon on this inforaation service, or at 202-232- 
4246 between the hours of 2 pa and 5 pa, Monday 



This dileaaa has been stated in this and other 
foruas as the biggest challenge facing any 
cospany offering an upgrade to the Color 
Coaputer. 

IMS is the only coapany to have taken this 
challenge head on. We started tackling this 
problem as long as two years ago. No other 
coapany has been as active for as long in 
creating this new OSK aarket. 

Dur first step was to aap out aethods for 
creating quality software quickly. Two aajor 
portions of that step are done. The MM/1 
supports a windowing systea strikingly 
compatible with Color Coaputer GS-3 windows. And 
the MM/1 supports a C graphics library that 
allows the easy porting of MultiVue based 
software to the MM/1. Other steps are in place 
now, and new software will start pouring in for 
the MM/1 by Christaas — without a lot of effort 
froa developers! 

yith new software available for the MM/!, now 
users have confidence to purchase it. The 
software developed on the MM/1 soaetiaes will 
work on the generic QS-3/b38«y platforas offeree 
by others including Peripheral Technologies, 
Tadpole, SE3PAC, Mizar, SIMIX, and others. 
Soaetiaes MM/1 software will NOT work on these 
platforas. Software will NOT work on other OSK 
platforas when a developer take advantage of the 
MM/Ts Sun(ta) workstation-style color 
architecture, or when a developer's application 
depends on the variable saapling rate of our 
built-in sound. 

It is up to the developers to aake their product 
work on other OSK coaputer systeas. These 
developers will aake changes to their product 
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tfhen ti*:SV D 3 1 1 9 V 8 Sales OH the otn o P ■"UatforfS* 

■ 1 t 1 -■ 1 _• t t -J 1_ ki J a > V : I ■ -J '■ J I : ■_ J. I -'VI'.- 



o ' $*■? loution c^aii^nce 



■ IS;"; jr^SOvMn 17'Q. a ■""'.' ^ * 1 '-i ' mC "'Ut : "-t the 'f--"^ 

,s;<en ateos in this direction. 



: -ib a, 



-o se<. 



fri.i^ai"- -^ thiM-csrsnc ; -.t 



1 



. I 14 H U 1 w '^ j , ■_■ 1 vhvujuiiuj -' i L LmUu tCI -r , -■ -i V V ^-" J'-l 1 

I h c reason ^ ' a c ! n a n e & (3 for - o - h g ~ ■'■ 3 ^ s s u c c £ s s 

r* 2 r ^ «c 5. r £ tor you c :-> !8 n uter for a c iono as v-u 
choose to use your comcuter . For a proarasaer to 
support hisiself.. he needs to sell you good 

c ii t f fii i p a 

Q:-: unit rjcon --liwo 1 nnapc inri Ka nacrtc './nn -- Ki ■ t 

vol: only need one of hi is. The proorasesr needs 
enouGh ilfi/l customers to sake a living. 

Let- ■ = do soffte quick arithmetic . If 53M$y 02? 

year is 5 reasonaDie salary, then the orograr^ner 
needs to sell !.$&& units of a product at a net 
profit of J3y each, oer year. If one in ten of 
Mh/1 owners buys a particular product {}$% 
penetration is actually the sign of a successful 
oroduct in a ssail siarKetr then the nusher of 
rlH/: owners must be 18,068. 



i*iU5. c " ; nne r t i v i tv and ^nte^ooeraoilitv is 
chall^n^e ahead of l'?.9\ and "he ™£/' S 
connecting to ^Cs Hacs and nain frames, tni 
Hrv i heccri^s another i r, c :i f^v ous'ness ^n: 



What I*S nas ac comoi ishad 



ilfi have solved the Software/Hardware Paradox. 

Tools are here now to help create Color Costouter 
0S~3 ' r o!^03iible software Tools ^il- be 
availaole in the Fall to ease the oortmo of 
UNIX software. Tools will De availaole Dy Winter 
to ease the portmc of BASIC, QmcitBasic , 
Mbasic. and SasicA oroora&s to the ilil/?. 

Plus, software devslocers nave already created 
n&$ oroducts for the ;ust-shiooino sIH/: . 3y 
Fall, sixty oeveloosrs yill oe actively creating 
ne ! a software for the ceisouisr. 



Nov. you can figure out how aany computers need 
to be shipped per seek to aeet that goal ~ 
that's 2sb units PER WEEK . That's why IHS nas a 
fuii-tisis staff now ano aiii expand it in the 
future. And what aoout IMS's sales leais? Hoy 
large does that have to be to field the iw^M 
phone calls and letters reauired to generate 

This is a serious bottleneck, and IMS is 

mm r a- * ! v thy fl^'l V r ftsninv with niinc in nlira 
to 50 1 V5 it. 



Goal: Solve the ^ainstreaa challenoe 



No computer has ever generated this level of 

anticioation ; excitement, and NEy PRODUCTS , 

Thanks gc to our supporters, ^ho sade it 
oossible 

Already available are a oamt program, LHarc 
dearchiving progras for Asiga files. Stuffit 
dearchiving program for Macintosh files, font 

art l t " p H oy tavt iriit ; -:!» i« ] t ^ n « * n r i n r? 

k_ ' J i V ^J I . I f ■— W V W J-\ W V* ^ i V J 4 ft I IfH Lrt ill V i .'U 

capabilities, sens fax. 
noteoad/ r a 1 cu ' ^to" .'scnedul e rt dis^ util'iic c 
sound playback applications. Autodesk Animator 
flicker animation olaver to play cac* ^C-baseo 
aniiaations, C grachus libraries to ease the 
oortinq of Hultivue orograas. 



For the HH/i to have wide success (and thus 
create a *ide sarket that benefits each of your 
it needs to survive the hardware and software 
reviews of aajcr aagazines. 

Every effort is being iaade to sake that 
possible. J'T\^ first step is the elusive FCC 
approval. The next step is compiling technical 
documentation and user documentation that sets 
it goals at educating and training a new 03- 
3/bSOtJtJ user. The usual fticorware sanuais will 



On the »ay is a goint-ano-ciics database, a 
checkbook program, sound saaole editor, new 
drivers for uitrafast hard drive access, file 
copying and deleting utilities using a aouse. 
SCSI digitizer for grabbing fraaes froa a video 
caaera or VCR, teleconferencing, electronic 
aail. aultiaedia database, suiti-line 3BS ; ana 
sore. 

Ho other Q3K system has been the host to this 
such develoosent activity, ever. Heipina us out 
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are oeooie like Kevin Darling, Kevin ^ease. *i:<; 
Haaland R9 ? f. ^cfiiisidsr Scott 3rif*oentr~G Min 
Giizzi, Dave Sever 'lark Griffith, ana olhars 
111c ludinc trie staff at CompuServe , Jiicroware 
Hunter Systems . T undra Software., ana Microsoft. 

Gn ^.n^ wav ^ :": tp " ~ r !'"rt "ff-war^ 1= tK Snu ■ 
cO'iiOiler and i — ""■ ^oi^ct^onsnted co»sci"'- Q r to 01 
tested by INS and its develcoers. tne- 
distributed with sattoie software, 7 nU cofiipi I a ■ 
will greatly ease the oorting of UNIX software 
t o v - ' * r r ri jl * 



ye have solved the Distribution chailenqe 



witnout soma into details tnat wouid reveal now 
-we have this advantage. IMS nas al ready begun to 
put into place an infrastructure that will 

.liniratp ti":C finmhar •'■. t eslsc c-inii^oH f •"■ 1-apn 

-j C : 1 -•■ . 3 v - tf 1 i w :>wnluCi vi ^ m 1 C -J i _ ,t i* i i i_ - j .■ w ■• i_ tT y 

v Li r ^rl/1 we H ~suooor tad 



we are solving ire -jamstreatt challenge. 

IMS nas passed another step of :ne -CC approval 
orocssv No national iv resnowned ^acazine will 
review a sac runs that is not FCC aporovso Nor 
15 it legal to sell computers tnat are 
r osoleti =i Iv ~ r, v- f i"u^: L d f*-f use v- — e ho&e 
without FCC aoprovai ; this is why I MS sells 



*n addition *-0 tn^ FCC aoprovai I^S is 
contmuino to seek, anotner unicue thino we are 

saoazmes and newspapers. Gver the next three 
sontns, expect to see so;«e national coverage on 



the MHi 



illl'J *J 1 > S. 1_ ■!_ ML J ■-* 1 I L V L» -.1 . t V J I -f 1 I 1 W U i 1 i *J -I 3 t i \ » ■ J -.4 , 

I MS will oe appearing in advsrtisisssnts to 
continue our crowth. 



BS/M irrncc *Hp itmtaj-i V+afac 3\r f Kg an-H ■■■ t 

1 t > 1 1 > j L 1 '^ j j .' 1 1 C ' < 1 i v '- '-i -j .fO'ji-j . w i vliu C 1 1 -j -■ 1 

July, a dozen will be in olace in key geographic 
regions Sv December IHS hooes to double this 
nuaber. Their locations are strategically 
located T.o or^vide access to our careful lv 
s^^ected sar ,,: '^ts 

By the aiddie of August, IHS sill announce \x<* 
nases. locations, phone nurabers, addresses : and 
other information aoout these reoresentatives 

'-'.Qr-nri T'flQ Hac Sa'Mn cat finn \\r% fi?:' ' 

■':in: ? t - r-.c -! « catiG cTrit^nir ircac "hie ~rri r^cc 

is slow on puroose — y?e anticipate a sanaoeaoie 
nusoer of retail outlets in place Dv October '\. 

Third I MS* has "ec^ntlv Greatly isorov^d its 

■z v c t i rti c f-iT* r ■-r-tfli'm i r a ♦ i nn mi fh « i^,»a:arit z t i vec 

_■ ) _ vi_ lit ^ 1 ■_• 1 . _■ ,'.1 111 Li 1 1 i ^ S L- J. 1 i'j « t t\\ ! -j : , 3. il ifd y l 1 u j . 

ceveiocers , and end users. This new svstesis sill 
be incrementally brought into effect over the 
next si x seek 

The result of these acco?HDiisnsents is that a 
high number of leads can De generated without a 
lot of sales overhead at IHS. <aeoinc our 
responsiveness high and overnead las. That saves 
you tiae and stonsy. With a nign nusber of 
qualified sales leads, IMS can help the 
representatives and retailers educate their 
potential customers through literature, videos, 
deaonstrations ; and visits by IMS staff. These 
leads will yield sales, and sales alios !HS to 
continue to bring new software and hardware to 
the M/l. 



Rnd tor your indorsation 



just m case you tnougnt we were sitting on our 
hands, ners is a list of yhat I. p aui ^ard, have 
done in the last sontri; 

i Coordinated the showing of the ftWl at two 

nay clubs 
i Prepared a new videotaoe showing rlh / 1 

Extended features 
t Sent orooosals -^c corresooncence to tnrae 



universities. wno see: 



tr,i ?Mf] 



mn as 



courseware tool 
* Send software and Hardware to ne* deveiooers 
? Sent software and hardware to old deveiooers 
i forked '^os^v with f:t(; a~o "r^e GS^ s^ 1 to 

ensure that a co^olete Mfi/1 svstesi is 

reviewed '"unlike the system that yas "eviewec; 

in the latest issue) 

-■ 'J VI J llll JJllUk' 3 7UllU*lll(J 

i Prepared literature for retailers (still in 

progress- 1 
t Prepared literature for reorssentatives 

(aiaost done) 
i Created new software p^ess releases 
i Designed our software catalog and oegan a 

hardware catalog 
t Tgsted new d a vi ro drivers 
t Had meetings with three investors 
I Began version 3 J of the mH/i User Suide 
t Compiled suggestions frca current MM/ 1 owners 
i Sketched out and started filling out the IMS 

Road flap for IHS developers 
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t Set up three new IMS representatives and two 

new IMS developers 
i Tested a new eouse 

t lapieiented tie* cue toner support services 
i Began scheduling sailings through the Fall 
i Met with and/or talked to representatives 

frois Scsith College. Asherst College, 

University of Massachusetts at Asherst j Nortr? 

Carolina State universi ty s University of 

Arkansas. University of Texas., and others 
t Talked with robotics and data acouisition 

companies in Texas, Massachusetts . Virginia, 

and North '"' a r '"' "■ ^ n 3 

i Uyr-nfipfi tnr nshi cfiftwirc tr.r ♦ r,& H*/*; ir he 

"v i i j i id I l '-^ w ^ i w i nwit 3 w ■, w m w ^ '*. i v * t"iw * » 1 i i v ■-■ w w 



x Began archi tec ting networkable Htultisedia 

I aa sure I left off quite a bit. Now, oultiply 
last Benin's activities by three (the number of 
full tise staff at IMS), and you've got an 
active coepany working very hard. 

If any o*" you have Questions or feedback, once 
again I'd like to say we are delighted tc near 
froa you. 



Best reoards 



% Arranged for a net oublisher for "Start 08-9'* 
* Sent a mailing tc CD-I and CD-Tv devsiooisent 

firas 
% Drcanized soae develooers to ensure they have 

new oroducts this susiser 



: u 'j» i. T , . IF C. i Li 

Interactive hedia Svs 

between 2 p^ and S pra, Monday through Friaav 



,t& 



oooooocogoOOOOOOGGGOooooooooco 

A Basicyn Tutorial 
b v B o b D e v r i e s 



Hai I'll bet you tnouqht you qot rid of se with 
the last article I did on Basics conversions' 
Kopei Here I as to (de)bug you souse sore. This 
aonth I will start looking at the brii coftsar.ds. 
First I will cover those that apoear in trie 
EasicOS Manual, and give sose example prograaee 
code to sho* how it is used. Then I will tell 
you about the extensions that ^-ere added to S r z2 
by Kevin Darling. The section of the manual tc 
read starts on cage 5-3: of the Basic?* manual 

I will start off by oescrioe the antics needed 
to create a graphics window so that you can 
actually use sose of the BFX2 cossantis. First, 
decide which type of graohics window you want. I 
will use a type 8 graphics wmcow. Here is hoe 
you open the window. 

OPEN Iwpaih.vw^UPDATE 

RUN GF)(2(wpath."DwSET E ; S ; r 6 ; d«.24^ ; 1,2) 

nm £FX2(ypath ; K SELECT K ) 

Here's what it all aeans; First, I ooened a path 
(using an INTESER variable woath) to the GENERIC 

■ i 1 1 'j ■_' ti u i_ J b. t i yJ v w ■- / n ± -m * 4j vih.' j s.- v ; ■ a i- fell 

orooraifise will work no matter wnat window 
descriptor is in use, as lone as one of theft! is 
available. If I had written the prograase L i *:: e 
the exaaoie on oage 9-S7 of the manual , anc 
"/wS*" was in use. sv crooraa^e woulc have cuit 



in the example), so that I can get input fros 
the window as well being able to draw on it. 

Next I used the DwSET call to tell 039 what sue 
etc to sake the new window. The numbers 
following the DWSET word are: 

3 is the window tyoe. This cives a 320 x 192 

I p, r-'\r,i\~ o^aohi^s s r reen 

y.O is tne location of the too left come" of 

the wmoow. 

40.2ii5 the width and height of the winoow in 

char 1 c ters 

6 ; l : 2are the foreground, background and border 

palette register numbers. 

OK. so now I have created the window, but one- 
thing is still Kissing I can : t see it yet. 

The next coraaand. SELECT, takes care of that. 

Right, now we can start to use soae of the 
graphics coiBS.ands. The ARC Copland draws an arc 
(part of a circle or elliose) on tne screen. 

nsT*'= a saKiols; 

run g'x2iwoath/ARC ,i ,5^.20jee,lO T ! ; M ; ^ 

I ffiusi aomi t that it too^ ae quite a whiie to 
ijiAT-i-; nxactiv h-w the nu. r i''" ,Ci ^ t !■"■ this ■" r f s - r ni 5 n '"■■ 

wo r 'r-e^ but I tnir,!;' I'v^ oot it Here ooes Th^ 
firs; two nuciihers are the location of the centre 
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■jQifit ''^ the eilios^ T^{? next two "usce^e are 

f.Sa : jr.ji y r 5tC : I -f thfi MIlDSe 3^ fa? 1 SO 

Good Now the next four numbers f o r ro the t»o 
sets of coordinates which, when you draw an 
isaoinary line ihroLicr; their:, fors the start and 
end ooints of the arc ynsre the ellicse touches 
that line, "his is aoproxisately oniy ; orobabiy 
due to inaccuracies in 8 bit fiaths, The manual 
cswgj ' h$q Define urayino *roi« the coint on tns 
screen closest, t* th a first set of coordinates 
■ Xcori vcoH '■ It st^os at the oortion of trie 
cr"flc"i closest to th'^ sec-n^ c e?- o* co or dilates 
(xcor2, ycor2) . : 

If you try something like this: 

*un o f x2 'woat^ ^ A R C r 2& ! \§ 2ft i;v S£ 2~.:5) 
run g?x2 Csoath ; "LINE 5 : 3^50,27, IS) 

You will fine that the line is parallel to a 
line cirasn through the two ends of the arc. 
Have a olay with that, and try the exasole on 
pace 9-51 of the iaanuai. It sons as long as 
you add the code to ooen the window around it. 
Bv the sav\ to close the wincioy and return to 
your norsai screen, this is the code ycu should 
use; 



tne c'"'"i -: is ^rawr: at trie rurr^nt orsonics 
cursor oos it ion 

"hz :"*r\j^ "^sRand is so&esha^ ^*" ^f^^n*. rro™ th° 
basic one., in that its direction sub-cossands 
are cospass ooints. instead of arbitrary 
Letters. So. v5 is north(uo) 5 oixels. S3 is 
south(ao^n) 3 pixels, and S£!0 is south-east 
v down-^iqnt ) i l 3 oixeis. As well as t n a t f the 






osoass -say oe 



deoraes at a ti«ie_. so RB is noma;. ^ is ?2 
deoress. A2 is ;S0 and A3 is 279 ^clockwise, of 
course/. Next we nave the cira* relative 
co^ano. L>23 45 yi"^ ^ray 3 ^ine ^o* the 
current cosition to coordinates '^3 ^5 without 
rnanosinG the cursor oositi^n ; J'tn this it. 
youio be fairly easy to usole&^nt the 'ravs' 
ciray that is so oopuiar with drawing orograases. 

'•'.••tr-.Wi cat t ho nr^irir- Try the ?zn\ i • 7-itl rantni 

oomt ; and then craw lines, using the 'dra* 1 
comsand, out to the souse location. Here's a 
bit of saapla code. 

run getaousa^path, souse* 

run g f x2 ( woa th _ : a pyTGC a , facuse . Ac X , aouse . Ac V } 

until souse. cosa <> 



run g?x2(y ; "SELECT") 
run gfx2(sDath, s 0!iiENL! i; ) 
close iwpath 

The next GFX2 ccasar.d in the manual is the ! BrR ; 
draw. This one will draw a filled box like the 
one in RSDOS that ooes 'LINEtx.v)- 



f si ,y! / ; KSt! .E!- . ihe parameters passed are 
exactly the saae. This is *nat it looks like: 

mx q!x2(*eat!VBAR\S(* 1 20 ; )w. ;3S; 

So. :et ; s nave a look at soae sore oraohics 
coissands. I cuess the box dratf should oe next. 
It : - oe s 1 1 k ^ this! 

run qfx2(woath. ;i SGr.xcor] .ycor! ,;<ccr"2.ycar2) 

If the first set of x and Y coordinates is left 
out, the box ail I De drawn froa the current 
graphics cursor position, whsrs you left off 
drawing sith the last co»sand. 

The circle coaaand, unlike RS8ASIC, QNIY drass a 
CIRCLE! So it is simpler than the basic one: 

run gfx2(woath, "CIRCLE 8 r xcar, ycor , radius) 

Again if the jf and Y coordinates are oaitted, 



xcor=sojse.Aci( 
ycor=so!i5e.AcY 

reoeat 

run get^ouse(ypath.aouse) 

■''•j,^, ^ f ?2(?o&v~ : "PU T SC r 'xaouse A c X 'souse ^c^ 1 

M<= ri !j s - 5 T r 5( X r 0r ;+* ; :i +=trf iycor) 

run gfx2(yoath [ "DRAy 3 U"$) 

until Niouse.cDsa=^ 

I'll try to explain this program sa^oie. 
Please note that not the snoie orograisse is 
dcDicted hers, for examde the orocedure 
'getisiouse' is not snown, also the vanaole niGusa 
is a CGEsolex variable set uo siiith tne TYPE 
coSniand. The first reoeat'until looo is used to 
siark tise. ana (neve tne graomes oomter around 
^'UTGO until a outton is oressed (the left 
one.*. Next a nes repeat-untii loop draws lines 
fros the point at whicn the outton aas pressed 
out to the current location of the qraohics 
cursor, until the button is released. Unless you 
know how tne rest of the code acrfes. 'and you 
don't, else you wouldn't be reading this) oon ; t 
try to use this code. I will supply a full 
woricing exaople in a later article. 

These next few cciaraands are used for text 
printing, except for the bel 1 cosaand, which, of 



August 1991 



Page 7 



AUSTRALIAN QS9 NEWSLETTER 



course, can oe jjeecJ at anv tinse. 
run q f x2 '* woa ?■ h " BELL " ' 

? up nt v9 ?' lu.n a t h " Qi Vik'fiiu 5 '» 
-!,n ,-it v7('i.ir,ii r, "Ej hik'*!*}'" 5 ^ 

7ho tir-ct cpn : i: i hoar. ♦ n *j-> ( a :r,6ji'ap t r,a 
-ar-itirt !ii ' " 1 wh* ^ny f ^! 1 nyi nn t avt i r. h 1 i « 'si ^ r> 

*J *. I. '.* 1 1 %4 * k h w J k7 V JM» 1 W * * \J H 4 M *^ Jb/^V W 'J w » * I 1 IV t i I -^ . 

NOTE! this only works on a TEH yindoa. T nat 



oni 



■VPS5 



am 



screens 



characters are: riui supported on a grammes 

cr^aan Tha lac? avampia ah0V a ^ c fh* ^':nv n f f 

call. 

This next one is only for GRAPHICS screens. li 

rhirvnac tha rhar^rtar cat tn Sfti H npintinn 

i.iIuiiui.3 j i l C Lnfli u'. i>u i 3 w v tfu uui.u y> t mvi >rj , 

run gfx2twpath/BuLl)Stf\ "ON") 
and off again. . . 

run gfx2<wpath : "BQLDSW 1 ' , 5 GFF S ) 

T Mil] nr.M tqi-'o c"i'*m (■■nRSinrtc r.Ht ,if cpnnprvrG 

i ■ I. 1. 1 |1U« uUJlL JUlllC iU|»lll»ll-JJ -JU V J I jtV'jCllkl.; 

hnt :itiro thau -lairinn ffViprhor 

Justified 



me ccaaands are used 
foreground, background ana bo 

rficriar t iwpli.' :-iiPO Thau ana 

run ofxtCsoath, "BORDER 5 .oalreq) 



nance the 
colours 



*un gfx2(*oatn "COLOR", *ore,baa,bord) 
^un qfx'iU'cath, 7l c 'AL£~TE :i : paireg : colour) 

? n *j*ju fi^ci r?ne the variable ; r n 1 r:-j {* J *s a 
palette raoister nufaoer : that is a number f *ros 
y to 15 inclusive. Be careful, the manual seeas 

♦O Pinnae* f'on i"iSuO M-^H"' that tT ic tha r/iinnf 
in *ha h:*!!»ria!* ni]at*a ?om'cTa"» that ic rni^niil 
b'Jt *hi- '- r, f"? -"■■ T^'P carnnH 1 j fip lie' ncac 

variables to represent tne palette registers to 
use for the foreground, background, ana oorder 
register. Here is the call ycu say use to 
change the actual colour :n the individual 
palette registers. The first value is the 
palette register nuaoer (tf to IS), and tne 
second is the colour value to place in it (3 to 
S3). 

yell, that will be enough for now, next Use I 

<»iu .-rMcant i - .-pan * at a yfirff i n '"! ^&? ^* a-.-asr. ■ ac 

for you to tvoe in and run. Until then ; ^eeo 
practicing anting 3asic£9 prograuiises. It is 

!»aallu n nt '■■■ i &t>\i ; *ii 1 1 * i-jil f Si/ tha wavf W inu 

iwui.41 ■, I w v rill w * ' i i w ki * -j . k/i viik n3i , i ■ 3!i t 

of vou hav^ anv orcbless or oo r,i t -ui^e 
understand ho* to do a particular asoect of 
Basics prograasmg, please write to as care of 

answer then if I can. 
Reoards, 
Bob Devries 



ooooocooooQQOOLikJGOuOoooooocoo; 

A C Tutorial 
Cnao^sr -i ~ PrnrjpiH Control 



THE WHILE LGQP 



The C 
s r -"uc tures 
branch i no 



Ue ii^ll ^!"iy^ r 



dTlu LuiiQi « i Uit3^. 

han all in I h i i 



chaoter and ye will beoin with the while loop. 
The shile loop continues to loop whi la soise 
condition is true, when the condition becomes 
false, the looping is discontinued. It 
therefore does just vhai it S3ys it does, the 
naiae of the loco oeing very descriptive. Loac 
the procjraift WHILE . C and display it for an 
exasoie of a *nile loop. ye begin si th a 
coaaent and the program name, then go on to 
define an integer variable 'count" within the 
body of the prograa. The variable is set to 
zero and we cose to the while loop itself. 

The syntax of a while loop is .just as shown 
here. The keyword "while 5 is followed by an 
expression of soaething in parentheses, followed 
by a coiapound statement bracketed by braces. As 



long as the expression in oarenthesis is true, 
ail statements within the braces will be 
executed. U this case, since trie vanaole 

■. J--M l ! it k J i!>.i k-iCii'Jkv w t vtik ■_ i i_ : i v k v'J C viik 



statements are executed 



will 



ev: 



tua, 



reacn 5, the statement will not oe executed, ano 



ih^ iooo will oe terminated 



k, -J I I 1/ 1 -J J 



'•acijijja a^ 



,ne 



:?st aman 



he program 
"ollowinc 



the statements in braces. *e will cover the 
coapare expression ; the one in parentheses, in 
tne next chapter. Until then, siaply acceot tne 
expressions for wnat you think they should do 
and you sill probably be correct. 

Several thinos aust be oomted out reqardinq 
the while loop. First, if the variable count 
were initially set to any nusher greater than 5, 
the statesenis within the loop would not De 



executed at all, so 



is possible to have a 



wniie loop that never is executed. Secondly, if 
the variable were not incremented in the loop, 
then in this case, the loop would never 
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terminate, and the d ? o a r s s wou Id never complete . 
Finally, if there is only one statement to oe 
e^e^uted within the Iooo it does not need 

h"3rac h.'i* r:p sf:nrt 3 i :i«a f'^tini 'a snH r-.;n 

thic np,*,rir: a- 

Vllt J Wl V4I U«l, 

THE OCHJHILE LOOP 

A variation of the ahile Iood is illustrated 
in the prog™ OGwHILE.C, which you should load 
and disoiav. This orooras is Dearly identical 

tfi *ha 1 icf nriCt avrant that tha I rnn ham nc wifK 

vw v I t w i3d v -jIiw l.miEiJ' una v »nw i w ^ u w t -^ * 1 1 j w * w 1 i 

the reserved word 3 do s [ to I lowed by a compound 
statement in braces., then the reserved word 
a while s . and finally an expression in 
parentheses. The statements in the braces are 
executed repeatedly as long as the expression in 
parentheses is true. Uhen the expression in 
parentheses becomes false, execution is 
terminated, and control passes to the stateaents 
following this statement. 

Several things ssust be pointed out regarding 
this statement. Since the test is done at the 
end of the loop, the statements in the braces 
will always be executed at leas* once. 
Secondly, if s i~ were not changed within the 
loop, the loop would never terminate, and hence 
the prograa would never terminate. Finally, 
just like for the while loop, if only one 
statement will be executed within the loop, no 
braces are required. Compile and run this 
program to see if it dees what you think it 
should do. It snouid cose as no surprise to you 

loop can be included within the coaoound 
statement of another iooo and the nestino level 
has no limit. 

I 1 1 w ■ Li f \ uuui 

~[h,a i( fr.i»" "[■":" £ jc "Pally HOthlnG H* 5 ^? '■ t '" c 

sifiioiy a new *ay tc describe the s while s Iooo. 
Load and edit the file naaed FQRLQGP.C for an 
example of a program with a K for" loop. The 
"for" loop consists of the reserved #ord "for :i 
followed by a rather large expression in 
parentheses. This expression is really coaoossc 
of three fields separated by seai-colons. T he 
first field contains the expression "index = tf a 
and is an initializing field. Any expressions 
in this field are executed prior to the first 
pass through the loop. There is essentially no 
liisit as tc what can go here, but good 
prograaaing practice would require it to be kept 
simple. Several initializing stateaents can be 
placed in this field, separated by cossias. 

The second field, in this case containing 



'■r^sv ■' .-.■* -c *hp ♦ac. ;.tr^-!*. ■= Hnna i* ?f,a 

Injun .' , .2 v ! • C u <u -i v ili> .ii * ~ .j-_- H ^ a '-■ viit 

r>iif!inni nn "i * ::r^. : or-n *wfr.i*nh fKo ~ n r. -n v- 3 r.i "t 

u i_ j * n 1 1 * 1 1 ■ j j ■ i. ^i w i i . UUw /ii! viiuil v ■. ' ~ _■ i ■»■ -J • w. hi . _ u 

can be any expression ^nich will evaluate to a 
true or ; alse. (Here will be said aooui the 
actual value of true and false in the next 

rkantaT* ' ! Tha ivrr«o-: z " r.rj -^nf^inaH in tha rhi".-i 

Liiuy vwi . ' ■ii— ■_ r*. i-- > w -i J j. --■ l l ■.'jhHiiil j t i i ;.- •. i w '.mil : 'j 

field is executed each tise the loop is executed 
but it is not executed until after those 
stateiaents in the naa in Dody of the loco are 
executed. This field, like the first can also 
be composed of several operations separated by 
cOmfsas 

Following the ?or() expression is any single 
or coapound statement wnich will be executed as 
the oodv of the Iooo. A cosoound statement is 
any aroup of valid C stateaents enclosed in 
braces. In nearly any context in C. a sirnoie 
statement can be replaced by a coaoound 
statement that sill be treated as if it were a 
single statement as far as orograa control goes. 
Cosset le and run this oroqrae. 

l<it IF STATEMENT 

Load and display the file IFELSE.C for an 
exasole of our first conditional branching 



■:t:t pmpn ♦ 



r\o 



f fl Notice first, that there 
is a H for B Iooo with a compound stateaent as its 
executable part containing two B if" statements. 
This is an exasple of how statements can oe 
nested. It should be clear to you that each of 
the a if s statements will be executed id tises. 

^ncirta" tha ?i*CT ''it' 1 ctstinont j" k chrtc 

vViiji-ju! linv ; u jv *t J w i w <— .lit- 1 1 v . I v j vUi uj 

with t.h^ kevwo^d a if H followed bv an ^xcr^ssion 

in fiip-snthocsc 7t t K« ivnr-accTnn ■= iualiiitoH 

*■■ yli .il viii 1 1_ _i . a i itt it- . ,'vui u jj i'j..i i j . i^iUu wj 

and found to o a t^ue th a sino^e = ^a^ a ;7{ Qn ^- 

foII^WnO ^h" '* "' :" " 1 c avors"fovi srsH if ^a^ c e 

the following statement is skipped. Here too,, 
the sinoie statement can be reolaced by a 
coitioourd statement co^oosed of several 
statements Pounded ov braces. 

>■-.'- _ , ■. w i ■_ j j *. v n .j u v Q w i. j J i '.:; wr 4 » djMn'j 

if the value of data is equal tc 2. this will be 
explained in detail in the next chapter. 
(Siscly suffice for now that if "data = 2 3 were 
used in this context, it would raean a coapletely 
0i rf er9nt thino ' NOiil ^OR the r ^"— ELSE "^""e second 
"if 5 is siailar to the first with the addition 
of a new reserved word, the Vise" following the 
first printf statement. This siapiy says that 
if the expression in the parentheses evaluates 
as true, the first expression is executed, 
otherwise the expression following the a eise 3 is 
executed. Thus, one of the two expressions will 
always be executed, whereas in the first example 
the single expression was either executed or 
skipped. Both will find many uses in your C 
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progressing sr torts . loapiie and run this 
aroqrsrjf: to see if it does what you exoect. 

THE BREAK AND CONTINUE 

Load the file naaed BREAKCQN.C for an 
example oi two new stateaents. Not i cs that in 
the first "for", there is an if statement that 
calls a break if xx equals 3. The break will 
juao out of the loop you are in and begin 
executing statements following the loop, 
effectively terminating the loop. This is a 
valuable statement when you need to juap out of 
a loop defending on the value of sorse results 
calculated in the loop. In this case, when xx 
reaches 3. the loop is terminated and the last 
value printed sill be the previous value, nasely 
7. The next "for 5 loop, contains a continue 
statement which does not cause termination of 
the loop but juaos out of the present iteration, 
when the value of xx reaches 3 in this case, the 
prograa will jursp to the end of the loop and 
continue executing the loop, effectively 
eiismating the print! statement during the pass 
tnrouqh the loop when xx is eight. Compile and 
run the prograa to see if it does what you 
expect, 

THE SWITCH STATEMENT 

Load and display the file SWITCH. C for an 
exaspie of the biggest construct yet in the C 
language, the switch. The switch is not 
difficult, so don't let it intimidate you. It 
begins with the keyword "switch 3 followed by a 
variable in parentheses which is the switching 
variable,, in this case "truck" As aany cases 
as desired are then enclosed within a pair of 



various case va:ues can De m anv oroer and ir a 



vaiue 



pAt fniir.il fha jlptsiiij nnrMfl" nt fr-.a 



oraci 



\a rocgpyfi^ Wf'rd 



.s usee to 



begin each case entered toiiowed oy the value or 
the variable, then a colon, ano the statements 
to be executed. In this exa^ole ; if the 
variable "truck" contains the value 3 during 
this pass of the switch statement, the prmtf 
sill cause s Ths value is three" to be displayed, 
and the a brsak a statement will cause us to jump 
out of the switch. 

Once an entry point is found, stateaents 
will be executed until a "break" is found or 
until the program drops through the bottoa of 
the switch braces. If the variable has the 
vaiue 5, the statements will begin executing 
where "case 5 : B is found, but the first 
stateaents found are where the case 3 statements 
are. These are executed and the break statesent 
in the "case 3" portion will direct the 
execution out the bottoa of the switch. The 



switch will be executed 



clear 



that any or the above constructs can be- nested 
within each other or olaced in succession, 

programing project at hand. 

Compile anci run SWITCH. C to see if it does 
snat you expect it to after this discussion. 
Load ana display the file SGIOEX . C for an 
exaapie of a file with soae "goto" statements in 
it. Tq use a "goto" stateaent, you sisply use 
the reserved word "qoto 3 followed by the 
syaboiic nase to which you wish to juso. The 
naae is then placed anywhere in the prograa 
followed by a colon. You are not allowed to 
juap into any loop, but you are allowed to .juap 
out of a loop. Also, you are not allowed to 
juap out of any function into another. These 
attempts will De flagged by your compiler as an 
error if you attempt any of thea. This 
particular prograa is really a sess but it is a 
Qood exasols of why software writers are trying 
to eliainate the use of the "goto 11 statesent as 
such as possible. 

The only place in this prograa where it is 
reasonable to use the "goto' 1 is the one in line 
11 where the prograa juaps out of the three 
nested loops in one juap. In this case it wouid 
be rather messy to set up a variable and juap 
successively out of all three loops but one 
"goto 8 statesent gets you cut of all three. 
Soae persons say the "goto" statement should 
never be used under any circumstances but this 
is rather narrow minded thinking, if there is a 
place where a "goto" will clearly do a neater 
control flow than soae other construct, feel 
free to use it. It should not be abused 
however . as it is in the rest of the prograa on 
your monitor. Entire booss are written on 
"goioless" progfaaaing, oetter known as 
Structured Prograaaing. These will be left to 
your study. 

One point of reference is the visual 
Caiculater described in Chapter U of this 
tutorial. This program is contained in four 
separately coapiled programs and is a rather 
large coapiax prograa. If you spend soae time 
studying the source code, you will find that 
there is not a single "goto 3 statement anywhere 
in it. Coapile and run GQTQEX.C and study its 
output. It would be a good exercise to rewrite 
it and see how auch sore readable it is when the 
stateaents are listed in order. 

FINALLY, A MEANINGFUL PROGRAM 
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Load the file n 3 rfi s d Tt^PCONv C for in 
exaraole of a useful ? even though somewhat 
limited program. This is a program that 
generates a list of cent icrade and farenheit 
temperatures and orints a message cut at the 
freezing point of vater and another at the 
boilinq coint of water. Of particular 



tance 



ins torraaitino 



he nearer 



Sleety several lines of ccsaents describing what 
the program does in a manner that catches the 
readers attention and is still o I easing to the 
eye. 

You sill eventually develoo your own 
formatting style, hut this is a good way to 
start. Also if you observe the for loop, you 



? i 



notice that all of the contents of 



-he 



compound statement are indented 3 spaces to the 
right of the "for" reserved »oro ; and the 
ciosina brace is lined up under the s f K in 
"for". This aakes debugging a bit easier 
because the construction becoaes very obvious. 
You will also notice that the "printf 3 
stateaents that are in the n if s statements 
within the bio "for 9 loop are indented three 
additional spaces because they are part of 
another construct. This is the first prograa in 
shich we used acre than one variable. The three 
variables are simply defined on three different 
lines and are used in the same sanner as a 
single variable yas used in previous programs. 



3y riat*r>inn fharn at\ .li ftaponf f i noc iria ^ivi i« 

opportunity to define each with a consent. 
^MOTHER °00R PROGRAMMING EXAMPLE 



K 9 ! " 5. 1 1 i n g I-SLyF ORil . C fros the last cnaoter 
vou say a very poorly forsatted oroarafi;. If vou 



an.i 



dis 



d iav 



OuHSCONV.C you will have an 



ioaa an 

example of poor formatting which is such closer 
to what you will actually find in oractice. 
This is the saae program as TErtPCONV.C with the 
consents reaoved and the variable naaes changed 
to resove the descriptive aspect of the oases. 
Although this program does exactly the saae as 
the last one, it is auth acre difficult to read 
and understand. You should beam to develop 
good programming practices now. Coacile and run 
this prograa to see that it does exactly what 
the last one did. 

PROGRAMING EXERCISES 

1. yrite a prograa that writes your nase on the 
fsonitor ten Uses, write this prograa three 
tiaes, once with each loooing method. 

2. yrite a progras that counts fros one to ten, 
prints the values on a separate line for 
each, and includes a stessaqe of your choice 
when the count is 3 and a different aessage 
when the count is 7. 
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Hose Phone ! Business Knone ! 



Age Group ipiease tick) under 18 [__] 1 S-25 [__] 25-35 [__] 36-45 >__i 4G-55 [__] over 55 
Go you run QS9 Level 1 [J Q'39 Level 2 [J OSK [_] (eiease tick) 

Tyno -if r.*imnti?pp fn« fK'Q * Mpf^:-PV V'Itg ' 
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utner Hardwire : 
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